File format for importing user information

    You can create a user and group file manually using an application that outputs an XML file. You can also write a script that processes an existing file (such as a list of enrolled students and courses) and outputs an XML file. The XML file you create must conform to the format shown below.

    The file below has three parts:
    • header information
    • user information
    • group information

    The header of the sample file defines the elements (uglist, user, group, and so forth) that are in the body of the file. The user information in the body of the file must precede the group information.

    Tip: For information on XML syntax, use Sherlock to search the Internet.

    The sample file shown below contains information for four users. The following information is listed for each user:
    • Name
    • Internet alias
    • Comment
    • Program linking enabled or not
    • Logon enabled or not
    • Whether the user can administer the server
    • Whether the user can change his or her password
    • Whether the user must change his or her password the next time he or she logs on
    • Whether the password is encrypted or in clear text
    • Information about a sample plug-in module (Instead of the sample shown here, you'd typically have information about mail settings for the user.)

    The sample file also contains information for a group named People with the group members Denis Serenyi, Forest Hill, Hali Kilbourne, and Megan Anderson.

Sample file

    <?XML version="1.0"?>

    <!DOCTYPE asipug [
    <!ELEMENT uglist ( user | group)* >
    <!ELEMENT user ( pass? disableDate? pluginDataList ) >
    <!ATTLIST user
    name CDATA #REQUIRED
    inetAlias CDATA #IMPLIED
    comment CDATA #IMPLIED
    uid CDATA #IMPLIED
    programLinking ( link | noLink ) "noLink"
    loginEnabled ( canLogin | noLogin ) "canLogin"
    isAdminUser ( isAdmin | notAdmin ) "notAdmin"
    passwordChange ( canChangePass | noChangePass ) "canChangePass"
    forcePassChange ( mustChangePass | passOkay ) "mustChangePass"
    >

    <!ELEMENT pass EMPTY >
    <!ATTLIST pass
    format ( encrypted | clearText ) "clearText"
    text CDATA
    >

    <!ELEMENT disableDate EMPTY >
    <!ATTLIST disableDate
    day CDATA #REQUIRED
    month CDATA #REQUIRED
    year CDATA #REQUIRED
    >

    <!ELEMENT pluginDataList pluginData* >
    <!ELEMENT pluginData EMPTY >
    <!ATTLIST pluginData
    signature CDATA #REQUIRED
    data CDATA #REQUIRED
    >
    <!ELEMENT group memberName* >
    <!ATTLIST group
    name CDATA #REQUIRED
    gid CDATA #IMPLIED
    >
    <!ELEMENT memberName EMPTY >
    <!ATTLIST memberName
    name CDATA #REQUIRED
    >
    ]>


    <uglist>
    <user
    name = "Denis Serenyi"
    inetAlias = "denis"
    comment = "Denis' Comment"
    programLinking = "noLink"
    loginEnabled = "noLogin"
    isAdminUser = "notAdmin"
    passwordChange = "noChangePass"
    forcePassChange = "passOkay" >
    <pass
    format = "encrypted"
    text = "&) ," />
    <pluginDataList>
    <pluginData
    signature = "samp"
    data = "Data from Sample Module" />
    </pluginDataList>
    </user>
    <user
    name = "Forest Hill"
    inetAlias = "forest"
    programLinking = "noLink"
    loginEnabled = "canLogin"
    isAdminUser = "isAdmin"
    passwordChange = "canChangePass"
    forcePassChange = "passOkay" >
    <pass
    format = "encrypted"
    text = "6**!#5 4" />
    <pluginDataList>
    <pluginData
    signature = "samp"
    data = "Data from Sample Module" />
    </pluginDataList>
    </user>
    <user
    name = "Hali Kilbourne"
    inetAlias = "hali"
    programLinking = "link"
    loginEnabled = "canLogin"
    isAdminUser = "notAdmin"
    passwordChange = "noChangePass"
    forcePassChange = "mustChangePass" >
    <pass
    format = "encrypted"
    text = ",$--" />
    <pluginDataList>
    <pluginData
    signature = "samp"
    data = "Data from Sample Module" />
    </pluginDataList>
    </user>
    <user
    name = "Megan Anderson"
    inetAlias = "megan"
    comment = "Megan's Comment"
    programLinking = "noLink"
    loginEnabled = "canLogin"
    isAdminUser = "isAdmin"
    passwordChange = "canChangePass"
    forcePassChange = "passOkay" >
    <pass
    format = "encrypted"
    text = ",u37'" />
    <pluginDataList>
    <pluginData
    signature = "samp"
    data = "Data from Sample Module" />
    </pluginDataList>
    </user>
    <group
    name = "People" >
    <memberName
    name = "Denis Serenyi" />
    <memberName
    name = "Forest Hill" />
    <memberName
    name = "Hali Kilbourne" />
    <memberName
    name = "Megan Anderson" />
    </group>
    </uglist>

Related topic

 
Table of contents